home *** CD-ROM | disk | FTP | other *** search
/ Net Connect / NetConnect - Version 1.iso / amitcp / read me first < prev    next >
Text File  |  1997-03-05  |  13KB  |  348 lines
  1. AmiTCP/IP DialUp 4.5 "Read Me First" File
  2. =========================================
  3.  
  4. This file contains notes on changes that didn't make to other documentation.
  5. Please read this through if you encounter any problems configuring AmiTCP/IP
  6. DialUp 4.5.
  7.  
  8. Contents:
  9.  
  10.  1. Summary of new features and improvements
  11.  2. Upgrading from earlier versions
  12.  3. Changes in the AmiTCP/IP setup
  13.     3.1 User information
  14.     3.2 IP provider setup
  15.     3.3 Serial line setup
  16.     3.4 Modem setup
  17.  4. Notes on supported Sana2 device drivers
  18.  5. Miscellaneous
  19.     5.1 db/User-Stopnet
  20.     5.2 ifconfig changes
  21.     5.3 Configuring without Domain Name Service
  22.  
  23. 1. Summary of The New Features and Improvements
  24. ===============================================
  25.  
  26.   This is the AmiTCP/IP DialUp Release 4.5 released 28-Jul-96.  This release
  27.   contains new features, minor bug fixes and performance improvements over
  28.   previous versions.
  29.  
  30.   Fixed bugs in 4.5:
  31.  
  32.     * BOOTP now works (again)
  33.  
  34.     * Configuration difficulties caused by small buffer sizes fixed
  35.  
  36.     * Maximum MTU raised to 1524 (was 1500).
  37.  
  38.   New features in 4.3:
  39.  
  40.     * Improved and simplified configuration with IP provider profiles
  41.  
  42.     * Direct Dial-Up support with BootPConfig
  43.             
  44.     * New improved SLIP device (aslip.device)
  45.  
  46.     * New API interface with Intelligent Priority Boosting
  47.  
  48.     * Improved Napsaterm Telnet/Rlogin tool, added WB-icons
  49.  
  50.     * Improved command line utilities (bootpconfig, ifconfig)
  51.  
  52.     * Improved Arexx interface
  53.  
  54.     * Default values shown in db/AmiTCP.config
  55.  
  56.     * socket.library for AS225 compatibility
  57.  
  58.   Fixed bugs in 4.3:
  59.  
  60.     * AmiTCP/IP license key file and AmiTCP/IP itself can now be stored in any
  61.       file system
  62.  
  63.  
  64. 2. Upgrading from Earlier Versions
  65. ==================================
  66.  
  67. The `Install AmiTCP' on the installation disk supports upgrading from
  68. earlier AmiTCP/IP versions.  To make use of the new features generally
  69. requires your to reconfigure AmiTCP/IP, though.
  70.  
  71. Although `Install AmiTCP' can copy existing AmiTCP/IP configuration files,
  72. there might be other files (configuration files, program files) that you
  73. have installed on top of the earlier AmiTCP/IP.  These files are NOT copied
  74. over automatically, and you must either copy the files manually, or
  75. reinstall the software in question.
  76.  
  77.  
  78. 3. Changes in The AmiTCP/IP Setup
  79. =================================
  80.  
  81. The way the configuration information is stored has been changed.  The main
  82. motivation has been to allow `Config AmiTCP' to recognize existing setup,
  83. and provide proper default values to allow configuration changes without
  84. requiring to re-enter *any* value, that does not need to be changed.
  85.  
  86. Also, the configuration information is divided into several independent
  87. categories:
  88.  
  89.   1) User information
  90.   2) IP provider setup
  91.   3) Serial line setup
  92.   4) Modem setup
  93.  
  94. These are handled in following subsections. 
  95.  
  96. 3.1 User Information
  97. --------------------
  98.  
  99. The default user name is stored in ENVARC:LOGNAME and ENV:LOGNAME.  LOGNAME
  100. variable is also set up by the login command, which means that when startnet
  101. is run, the user will not be changed.  However, the configured default user
  102. is restored when the ENV: is initialized from ENVARC: during a reboot.
  103.  
  104. The `login' command has been changed so that with usage "Login -f" it reads
  105. the user name to login from ENV:LOGNAME.
  106.  
  107. The password setting during configuration has been made optional.  Other user
  108. information (real name, home directory etc.) is asked as before.
  109.  
  110. 3.2 IP Provider Setup
  111. ---------------------
  112.  
  113. This release introduces "Provider profiles".  These files collect all IP
  114. provider specific information into one place.  In other words, switching
  115. providers just means replacing the existing profile with a new one!
  116.  
  117. This release contains few ready made profiles, but you should ask your
  118. provider whether they already have a profile for the AmiTCP/IP.  If they do,
  119. fine, that's all you need.  But if they do not, then you need to create one.
  120.  
  121. The information needed to make the profile is not dependent on the computer
  122. platform, and exact instructions for some other platform will be of great
  123. help in making the profile for the AmiTCP/IP.
  124.  
  125. If you provide the information from your provider, we can help you to
  126. complete the script (via email to AmiTCP-Support@nsdi.fi).  We also intend
  127. to make the scripts available via our WWW service <http://www.nsdi.fi/>.
  128.  
  129. Profiles are stored in directory `AmiTCP:Providers'.  The currently used
  130. profile is stored in `AmiTCP:db/Provider.conf'.  The profiles in
  131. `AmiTCP:Providers' include:
  132.  
  133.   FIN_Kolumbus             - Kolumbus Internet Finland (static SLIP)        
  134.   FIN_PersonalEunet        - Eunet Finland (PPP)
  135.   FIN_TeleInetOpen        - Telecom Finland InetOpen (SLIP, BOOTP)
  136.   GER_T-Online             - German T-Online (dynamic SLIP)
  137.   Other                - Template for DialUp IP providers
  138.  
  139. If the profile does not set the name server information, then they are
  140. stored into `db/resolv.conf' by the `Config AmiTCP'.  This file will be
  141. overwritten by some provider profiles (see NSDynamic below).
  142.  
  143. The provider profile contains two parts.  The first part starts from the
  144. first line with "/*", and ends with the line starting with "*/".  This part
  145. contains configuration information, which `Config AmiTCP' interprets and
  146. modifies.  Bootpconfig also uses this information when configuring
  147. AmiTCP/IP.
  148.  
  149. Fields in this section are:
  150.  
  151.     Name        Name for this profile
  152.     DialUp        1 if modem is needed.  This is how `Config AmiTCP' 
  153.             knows to ask modem configuration.
  154.     Interface    Network interface name to be configured
  155.     InterfaceConfig Provider specific Sana2 options.  Appended to serial
  156.             configuration from db/autointerfaces to form a
  157.             Sana2 device configuration file.
  158.             Only provider specific options should be set here.
  159.     NeedSerial    1 if a serial line is needed.  This is how
  160.             'Config AmiTCP' knows to ask serial line related
  161.             options.
  162.     IPDynamic    1 if IP address is dynamic, 0 otherwise
  163.     IPAddr        IP-address if static, leave blank if not known.
  164.             'Config AmiTCP' will ask this if necessary.
  165.             Bootpconfig can ask this at startup time also.
  166.     DestIP        Destination IP address.  This is NOT needed for
  167.             dialup configurations.
  168.     Gateway        Default Gateway address.  This is NOT needed for
  169.             dialup configurations.
  170.     Netmask        Netmask of the interface.  This is NOT needed for
  171.             dialup configurations.
  172.     NSDynamic    1 if name server configuration is dynamic.  In this
  173.             case the dial script should set the name server
  174.             addresses ("Set NS1 x.x.x.x"). 0 otherwise.
  175.             Bootpconfig will create db/resolv.conf and 
  176.             db/netdb-myhost (for compatibility with old email
  177.             programs) at startup time if name server configuration
  178.             is dynamic.
  179.     UseBootP    1 if BOOTP protocol should be used to configure
  180.             dynamic IP address, 0 otherwise.  Your IP provider
  181.             must support BOOTP for you to be able to use it.
  182.     MTU        Maximum transmit unit (in bytes) to use.  The maximum
  183.             receive unit size is set in Sana2 configuration and
  184.             is set to maximum by `Config AmiTCP'.
  185.             0 represents the default maximum value, which should 
  186.             be used on all LAN configurations.
  187.     Phone        Provider phone number(s).  Dial script command "Dial"
  188.             (in AmiTCP:ssrx/Dial.ssrx) will get this through
  189.             bootpconfig.  It is in this section for
  190.             'Config AmiTCP' to be able to configure it.
  191.             Multiple phone numbers are separated with spaces.
  192.  
  193. The rest of the file is used as a dial-up script.  As you see, the script
  194. language is ARexx.  Scripts can contain AmiTCP/IP scripting commands in
  195. addition to normal ARexx commands.  The command set is documented in
  196. help/AmiTCP.guide.
  197.  
  198. If you use the "Other" profile, then a default manual login script is
  199. appended to your profile.  You can use this script to test the login
  200. procedure, and then automate it when you need what kind of conversation is
  201. needed with the IP provider service.
  202.  
  203. An example provider profile:
  204.  
  205. ---8<---8<---8<---8<--->8--->8--->8--->8---
  206. /* Provider Configuration Follows:
  207. Name        Other        ; Name for this configuration
  208. DialUp        1        ; This configuration needs a modem
  209. Interface    slip        ; Interface name
  210. InterfaceConfig ""        ; Provider specific Sana2 options
  211. NeedSerial    1        ; This configuration needs a serial line
  212. IPDynamic    0         ; 1 = YES, 0 = NO
  213. IPAddr                ; IP-address if static
  214. NSDynamic    0        ; 1 = YES, 0 = NO
  215. UseBootP    0        ; 1 = YES, 0 = NO
  216. MTU        576        ; Provider specific
  217. Phone                ; Provider phone number (without spaces)
  218. */
  219. /* The rest is the Dialer script for this provider */
  220. options results
  221. signal on error
  222.  
  223. Say "Entering Manual Console Mode."
  224. Status "Please log in"
  225. ManualConsole
  226.  
  227. exit 0; /* Successful exit */
  228.  
  229. error:
  230. Say "Command on line" SIGL "returned" RC ":" SerScript.LASTERROR
  231. Exit 10
  232. ---8<---8<---8<---8<--->8--->8--->8--->8---
  233.  
  234. 3.3 Serial Line Setup
  235. ---------------------
  236.  
  237. The serial line configuration is stored in db/autointerfaces.  You
  238. should not manually modify the db/autointerfaces file, but use the
  239. 'Config AmiTCP' to manage it.
  240.  
  241. The `Shared mode' is offered as the default.  If Shared mode is used, the
  242. dialup can be done without setting the modem to the ignore DTR mode (AT&D0).
  243. This allows the modem connection to be dropped automatically when AmiTCP/IP
  244. is terminated.
  245.  
  246. The EOF-mode setting is automated by both aslip.device and the newest
  247. version of the ppp.device.  These devices use the EOF-mode on only on devices
  248. known to support it.  You can enforce EOF-mode on or off by giving an
  249. additional serial option, EOFMode or NoEOFMode, respectively, when `Config
  250. AmiTCP' asks for additional serial options.
  251.  
  252. EOF mode is a technical detail in serial device usage that affects the CPU
  253. usage of the serial traffic.  EOF mode should be used if possible, but
  254. unfortunately some add-on serial boards and replacement serial drivers do
  255. not implement it.  If you are using the normal AmigaOS serial.device with the
  256. internal serial port, then you do NOT need to bother about the EOF-mode at
  257. all.
  258.  
  259. The MTU value stored in db/autointerfaces is used as `MRU', i.e. `Maximum
  260. Receive Unit', the maximum size allowed for an incoming packet.  This is
  261. always kept at maximum by the `Config AmiTCP', and should NOT be modified.
  262. This version of AmiTCP/IP allows MTU (Maximum Transmit Unit, the maximum
  263. size of sent packets) to be set independently.  This value is asked in `IP
  264. provider options' and is stored in the IP provider profile.  This value can
  265. also be changed and viewed at the run time with `ifconfig' utility.
  266.  
  267. The DoOffline option included into SLIP and PPP configuration in the
  268. file `db/autointerfaces' instructs AmiTCP/IP to put the Sana2 device
  269. offline when AmiTCP/IP is stopped.  Putting SLIP or PPP device offline
  270. will cause the modem connection to be dropped, if DTR is not ignored
  271. by th modem (AT&D0 is not configured in modem init string).
  272.  
  273. 3.4 Modem Setup
  274. ---------------
  275.  
  276. 'Config AmiTCP' now also asks for the modem configuration.  This includes
  277. modem initialization string, and the dialing prefix.  These are stored in
  278. ENV:ModemInitString and ENV:ModemDialPrefix, respectively (also in ENVARC:).
  279.  
  280. The modem initialization string is dependent of the modem you have.  If you
  281. are using a terminal program, you probably have a modem initialization
  282. sting configured for it.  This can be used as is with AmiTCP/IP as well.
  283.  
  284. Generally the modem initialization string should contain the following:
  285.  
  286.   1) The command introducer    "AT"  (for Hayes compatible modems)
  287.   2) Reset to factory defaults:    "&F" 
  288.   3) Sense carrier:        "&C1"
  289.   4) Disconnect on DTR drop:    "&D2"
  290.   5) Hardware handshake:    "&R1" (7Wire mode, need 7 wire cable)
  291.  
  292. You need to confirm the actual values from the manual of your modem.  The
  293. scripts using the ModemInitString assume it to return OK, so at least the
  294. command introducer must be given.
  295.  
  296. The modem dial prefix is usually "ATDT" (touch tone dial).
  297.  
  298.  
  299. 4. Notes on Supported Sana2 Device Drivers
  300. ==========================================
  301.  
  302. AmiTCP/IP DialUp supports only following Sana-II drivers:
  303.  
  304. SLIP:    aslip.device is a new slip Sana2 device with slightly modified
  305.     configuration file interface. `Config AmiTCP' requires it if
  306.     SLIP protocol is used.
  307.  
  308. PPP:    ppp.device version 1.45 or later is needed for PPP.  Evaluation
  309.     version is available from AmiNet (for example wuarchive.wustl.edu),
  310.     file /pub/aminet/comm/net/PPP1_45.lha.
  311.  
  312.  
  313. 5. Miscellaneous
  314. ================
  315.  
  316. 5.1 `db/User-Stopnet'
  317. ---------------------
  318.  
  319. The `stopnet' script has been modified to execute `db/User-Stopnet', if it
  320. exists and AmiTCP/IP is running.
  321.  
  322. 5.2 `ifconfig' Changes
  323. ----------------------
  324.  
  325. Ifconfig now supports new usage, `ifconfig' without any arguments.  It shows
  326. the currently configured interface.
  327.  
  328. Ifconfig also gives textual presentations to all interface flags that are
  329. set.  It also reports the set MTU, hardware type and hardware address, if
  330. applicable.  The MTU can also be set, for example:
  331.  
  332.     ifconfig slip mtu 296
  333.  
  334. will set the MTU of the interface `slip' to 296 (`slip' is assumed to be
  335. configured already).
  336.  
  337. 5.3 Configuring AmiTCP/IP without Domain Name Service
  338. -----------------------------------------------------
  339.  
  340. If you run AmiTCP/IP without a connection to the Internet, the Domain Name
  341. Service might not be available.  AmiTCP/IP configuration expects that it can
  342. find out the host name from the IP address of your Amiga.  If the domain
  343. name service is not available, you should add a suitable IP-address-to-
  344. host-name mapping to the `AmiTCP:db/hosts' file.  See the existing `hosts'
  345. file for the format of the file.
  346.  
  347. EOF
  348.